/*-------------------------------------------------------------------------
 *
 * pg_partitioned_table.h
 *	  "分区表"系统目录的定义
 *	  (pg_partitioned_table)
 *
 *
 * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 * src/include/catalog/pg_partitioned_table.h
 *
 * NOTES
 *	  Catalog.pm模块读取此文件并推导模式
 *	  信息。
 *
 *-------------------------------------------------------------------------
 */
#ifndef PG_PARTITIONED_TABLE_H
#define PG_PARTITIONED_TABLE_H

#include "catalog/genbki.h"
#include "catalog/pg_partitioned_table_d.h"

/* ----------------
 *		pg_partitioned_table 定义。 cpp 将其转换为
 *		typedef struct FormData_pg_partitioned_table
 * ----------------
 */
CATALOG(pg_partitioned_table,3350,PartitionedRelationId)
{
	Oid			partrelid BKI_LOOKUP(pg_class); /* 分区表 oid */
	char		partstrat;		/* 分区策略 */
	int16		partnatts;		/* 分区键列的数量 */
	Oid			partdefid BKI_LOOKUP_OPT(pg_class); /* 默认分区 oid;
													 * 如果没有则为 0 */

	/*
	 * 可变长度字段从这里开始，但我们允许通过 C 结构直接访问
	 * partattrs。 这是因为堆元组的第一个可变长度
	 * 字段可以通过其 C 结构偏移量可靠访问，因为之前的所有字段都是不可为 null 的固定长度字段。
	 */
	int2vector	partattrs BKI_FORCE_NOT_NULL;	/* 数组的每个成员是
												 * 分区键列的属性编号，或者如果该列实际上是
												 * 表达式则为 0 */

#ifdef CATALOG_VARLEN
	oidvector	partclass BKI_LOOKUP(pg_opclass) BKI_FORCE_NOT_NULL;	/* 用于
																		 * 比较键的操作符类 */
	oidvector	partcollation BKI_LOOKUP_OPT(pg_collation) BKI_FORCE_NOT_NULL;	/* 用户指定的
																				 * 键的排序 */
	pg_node_tree partexprs;		/* 分区键中的表达式列表;
								 * partattrs[] 的每个零项对应一个项目 */
#endif
} FormData_pg_partitioned_table;

/* ----------------
 *		Form_pg_partitioned_table 对应于指向具有
 *		pg_partitioned_table 关系格式的元组的指针。
 * ----------------
 */
typedef FormData_pg_partitioned_table *Form_pg_partitioned_table;

DECLARE_TOAST(pg_partitioned_table, 4165, 4166);

DECLARE_UNIQUE_INDEX_PKEY(pg_partitioned_table_partrelid_index, 3351, PartitionedRelidIndexId, on pg_partitioned_table using btree(partrelid oid_ops));

/* partattrs 可以包含零 (InvalidAttrNumber) 以表示表达式 */
DECLARE_ARRAY_FOREIGN_KEY_OPT((partrelid, partattrs), pg_attribute, (attrelid, attnum));

#endif							/* PG_PARTITIONED_TABLE_H */
